home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / china303.zip / CHINA.DOC < prev    next >
Text File  |  1993-02-01  |  8KB  |  220 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                       China Sea Trader DOOR program for PCBoard 14.x
  11.                                    Release 3.3
  12.                                  April 15th 1990
  13.  
  14.  
  15.  
  16.                 Written by - Roland Haley
  17.                 Rural Route #7  Woodstock
  18.                 Ontario  N4S  7W2  Canada
  19.  
  20.  
  21.  
  22.  
  23.  
  24.               HALEY'S COMMENT BULLETIN BOARD
  25.                  USRobotics HST 9600-baud
  26.                   (519) 469-3028
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                      DOOR Setup
  56.  
  57.       Make a batch file to run the DOOR as described in your PCBoard
  58.       (R) documentation.
  59.  
  60.                       Example:
  61.  
  62.       CD \DOORS
  63.           CHINA CHINA.CFG  <== Runs CHINA.EXE passing a parameter of CHINA.CFG
  64.       CD \PCB                   An example of this file is below.
  65.       BOARD
  66.  
  67.  
  68.                          Example CHINA.CFG file:
  69.  
  70.       C:\PCB\PCBOARD.SYS          <== The location of this file
  71.       Haley's Comment BBS         <== The name of your BBS
  72.       Roland                      <== The SysOps FIRST name
  73.       Haley                       <== The SysOps LAST name
  74.           0                           <== Registration number
  75.  
  76.                 Environment Variables
  77.  
  78.  
  79.       Two environment variables must be set in your AUTOEXEC.BAT file:
  80.  
  81.           SET LIB=<drive:><path to DORPCH35.EXE>  Note: ONLY the PATH !
  82.  
  83.       Example:  SET LIB=C:\MYLIB
  84.  
  85.           The DORPCH35.EXE run-time library must then be placed in this
  86.       directory.  If you keep the library in the <current directory>
  87.       with the DOOR program then this environment variable is NOT
  88.       required.  I would suggest a separate directory - perhaps a
  89.       RAMDISK as I do on my system.
  90.  
  91.  
  92.           SET DOORPCH=PCB     This variable tells DORPCH35.EXE it is
  93.                   running on a PCBoard system
  94.  
  95.  
  96.           All DOORPCH 3.5 DOORS require the DORPCH35.EXE run-time library
  97.       and the Microsoft (R) QuickBASIC 3.0 run-time library,
  98.       BRUN30.EXE, be present.  Your DOOR program may have come with
  99.           these files in the ZIP file.  If they are not present, this DOOR
  100.       program WILL NOT RUN.  You should contact the DOOR author if the
  101.       files are missing.  You require one and only one version of these
  102.           two libraries for ALL DOORPCH 3.5 DOORware.  The files are also
  103.           available in DORPCH35.ZIP available on most PCBoard Bulletin
  104.       Board Systems.  If you wish a fully detailed explanation of how
  105.       DOORPCH operates with DOORS, then you may read the documentation
  106.           within the DORPCH35.ZIP file within which this documentation may
  107.       be found.
  108.  
  109.                    DOOR Operation
  110.  
  111.       When the DOOR is in operation you have complete control over the
  112.           caller.  This DOOR was written using DOORPCH version 3.5.  The
  113.       logic is safe.  However, if something goes wrong - like real bad
  114.       wrong, sorry but we probably can't help.  Every precaution has
  115.       been taken to insure this code works flawlessly.  If it doesn't,
  116.       let us know.  Many function/operational keys are at your
  117.       disposal/use:
  118.  
  119.       F1   -    Displays the version of DOORPCH compiled and linked
  120.             into the DOOR.
  121.       F2   -    Displays a callers Alias if one is used via the Door
  122.             Monitor program (DOORPCH version) - future.
  123.       F3   -    Reserved for the future.
  124.       F4   -    Toggles the Bell on/off. May activate the DOOR Bell.
  125.             Value is returned to PCBoard when DOOR completes.
  126.       F5   -    DOS Shell. Allows SysOp to exit to DOS from inside a
  127.             DOOR.
  128.       F6   -    Displays available MEMORY and available STRING space.
  129.       F7   -    Toggle the alarm on/off. May activate the DOOR Alarm.
  130.             Value is returned to PCBoard when DOOR completes.
  131.       F8   -    Returns the caller involuntarily to PCBoard.
  132.       F9   -    Toggles the display on/off.
  133.             Value is returned to PCBoard when DOOR completes.
  134.       F10  -    Activates SysOp / Caller CHAT mode within the DOOR.
  135.       ESC  -    Deactivates CHAT mode. DOOR is resumed.
  136.       HOME -    HELP key for line 24/25 capabilities.
  137.       END  -    Displays Callers name and miscellaneous information.
  138.       PG-DN-    Displays Data Phone, Home Phone, Security Level
  139.             Uploads, Downloads and Expiration Date.
  140.       PG-UP-    Displays Comments from the callers USER record.
  141.       UP -      Allows the SysOp to temporarily add additional time
  142.             to the caller while in the DOOR. This time is NOT
  143.             returned to the BBS.
  144.       DN -      Allows the SysOp to temporarily subtract time from the
  145.             caller while in the DOOR. This time is NOT returned
  146.             to the BBS.
  147.       ALT-N -   SysOp next on control/indicator.
  148.             Value is returned to PCBoard when DOOR completes.
  149.       ALT-X -   PCBoard will exit after current caller completes their
  150.             session.  Value is returned to PCBoard when DOOR
  151.             completes.
  152.  
  153.       If you are running in NON-GRAPHICS mode, you MUST have ANSI.SYS
  154.       installed as a device driver in your CONFIG.SYS file:
  155.  
  156.                   Example: DEVICE=ANSI.SYS
  157.  
  158.       DOORPCH uses this device driver for displaying all colors to the
  159.       local console.  Color Graphics will always be sent to the local
  160.       console if you have defined to PCBSetup that you are running
  161.       graphics on the local monitor.  If a caller is in non-graphics
  162.       mode (NG) on line 25,  you will still see colors if PCBSetup has
  163.       been configured  that way.  The reverse is also true.  If the
  164.       caller is in graphics mode (GR) on line 25) and the local console
  165.       is defined to be in non-graphics mode then colors will NOT be
  166.       displayed to the local console.
  167.  
  168.  
  169.                     BELL
  170.  
  171.       DOORPCH logic will not allow a BELL to be sent to the local
  172.       console when the local screen is inactive (F9 OFF).
  173.  
  174.  
  175.  
  176.  
  177.  
  178.                        ERRORS
  179.  
  180.       All errors should recover and cause the DOOR program to exit
  181.       gracefully and return to the main system.  All errors are logged
  182.       in the "DOORPCH.ERR" file. The error number and line number are
  183.       included with the date and time.  Errors will be either caused by
  184.       the main module (the authors code, contact him) or the doorpch
  185.       sub (contact DOORPCH people).  It should NEVER cause the board to
  186.       hang.  If your board hangs, you are obligated to contact the
  187.       appropriate party and report the error and circumstances that
  188.       caused it.  Because we are using Microsoft's (c) QuickBASIC 3.0
  189.       run-time routines, it is possible that basic will detect a fatal
  190.       error condition.  As mentioned above, we have taken every
  191.       precaution, but simply cannot code for every error condition.
  192.       The Door should run without error.
  193.  
  194.  
  195.  
  196.  
  197.       If you are running this door on your system, and find it to be
  198.       entertaining. Please register your copy by sending $20 to:
  199.  
  200.                  HALEY'S COMMENT BBS
  201.                     R.R.#7
  202.                   Woodstock, Ontario
  203.                   Canada     N4S 7W2
  204.  
  205.       Include the exact display name of your BBS for your registration
  206.           number. Or for a quicker way (VISA/MC) call (519) 469-3028
  207.       after logging on in the normal manner, open door 6. This will ask
  208.       for your information and then give you the registration number to
  209.           place in the CHINA.CFG file. The door program will then run with
  210.           the following enhancements.
  211.  
  212.           Add the following to the CHINA.CFG file
  213.  
  214.           30                          <== Max number of moves daily
  215.           D:\GAMES\BLT-10.3           <== Drive, path and name of bulletin
  216.  
  217.           This will allow you to control the number of moves a user is allowed
  218.           to make daily. Also, if you do not want a bulletin, you can leave
  219.           that line blank.
  220.